home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / faxdor14.arc / ECHOFAX.DOC < prev    next >
Text File  |  1991-04-28  |  9KB  |  197 lines
  1. ==============================================================================
  2.  
  3.                          EchoFax Event Utility
  4.  
  5.                FAX Service for PCBoard 14.x Message Bases
  6.  
  7.                        $20.00 to purchase EchoFax
  8.                       $10.00 to Register Fax-Door
  9.  
  10.                                    or
  11.  
  12.                     $25.00 to purchase both Products
  13.  
  14.               Written by: Gerry Freymann
  15.                           R.R.#1
  16.                           Baltimore, Ontario Canada
  17.                           K0K 1C0
  18.  
  19.           The Phantom BBS (416) 342-3734 USR HST Dual Standard
  20.                           (416) 342-3766 19200 USR HST
  21.                           (416) 342-5573 19200 Hayes Ultra
  22. ==============================================================================
  23.  
  24.  
  25. Overview of EchoFax
  26. ---------------------------------------------------------------------------
  27. EchoFax was written to provide a simple method of scanning a PCBoard
  28. 14.x message base for outgoing Fax messages.  All you require is a
  29. Fax card and BitFax software.  How often you decide to scan for outgoing
  30. fax messages is up to you.
  31.  
  32. EchoFax operates in the following manner.
  33.  
  34. Any message with a subject of FAX will be exported for faxing.  EchoFax
  35. supports LOCAL and LONG DISTANCE faxing.  You can verify local prefixes
  36. by creating a file called ECHOFAX.PRE.  Long Distance calls are only granted
  37. to users with credits that you assign using the EFUSER.EXE program.  The To
  38. and From fields will be used in the covering letter and if you wish to
  39. customize the covering letter, you can create a 51 line ECHOFAX.PGE file that
  40. will be combined with the canned cover letter.  The destination phone
  41. number should be placed on the first line of the message.
  42.  
  43. If a message is faxed out successfully, it will be (K)illed.  If there was
  44. a problem with the phone number, the original message will be flagged as
  45. Read and the SUBJ will be changed to include a short comment on what the
  46. problem was.  If the line was busy, nothing will appear to be done to the
  47. message and it will be attempted again next time you execute EchoFax.
  48.  
  49. A batch file is provided, outlining how the EchoFax program should be
  50. run.  You need a version of DOS that supports the CALL feature within
  51. batch files.
  52.  
  53. We are in our initial Beta Testing, and are open to suggestions on our
  54. program.
  55.  
  56. All in all, I think you'll be quite pleased.
  57.  
  58.  
  59. EchoFax Requirements
  60. --------------------------------------------------------------------------
  61. First of all, EchoFax may not be for everybody.  There are a few
  62. requirements you should be aware of, that may make this utility unsuitable
  63. for some Bulletin Board Systems:
  64.  
  65. - You'll need room in your computer for an internal Fax-Card.  That not only
  66.   means physical space, but also free interupts and com ports.
  67.  
  68. - You need an extra phone line that can be dedicated or properly time shared
  69.   with the fax card.
  70.  
  71. - You need a Fax board that uses the BitFax software (C) 1989 BIT Software,
  72.   Inc.  All Rights Reserved.  I have used BitFax v.2.061 and 2.062
  73.   successfully.  I have reports that v3 works as well.
  74.  
  75. - EchoFax assumes a local call is 7 or 5 digits in length (minus brackets &
  76.   dashes).  If you are in a location where a local call is more, than you'll
  77.   need a customized version.  Please contact me and provide details and we
  78.   can get you set up.  Example local call:  3425544 or 25544
  79.  
  80. - EchoFax also assumes that a long distance call is 8 or 11 digits in length
  81.   (minus brackets and dashes).  Again, if this a problem in your location
  82.   please contact me and we can get you set up with a customized version.
  83.   Example long distance call:  14163425544 or 13425544
  84.  
  85. - EchoFax will ignore any phone number 4 digits or less, 6, 9 or 10 digits
  86.   or 12 and great and report these as invalid numbers.  If this is a problem
  87.   for you please contact me.
  88.  
  89. - Since this program is written in Turbo Basic file sharing is not
  90.   supported.  This will create problems if somebody else is accessing
  91.   the message base at the same time EchoFax wishes to scan for outgoing
  92.   fax messages.  EchoFax will retry, once per second, for up to 30
  93.   consecutive seconds, but I cannot guarantee success if your system is
  94.   up and running.
  95.  
  96.  
  97. Files used for EchoFax Operation
  98. ---------------------------------------------------------------------------
  99.  
  100. ECHOFAX.EXE --> The heart of our system.  This program and supporting data
  101.                 files should be placed in your \BITFAX subdirectory.
  102.  
  103.   DOFAX.BAT --> Calls up and executes EchoFax and BitFax as needed.  This
  104.                 should be placed in your \BITFAX subdirectory.  If you want
  105.                 to run EchoFax from your EVENT.SYS file, you should change to
  106.                 your \BITFAX subdirectory and CALL this batch file, passing
  107.                 on the full drive, path and filename of the message base you
  108.                 need scanned.  If you are going to scan more than one message
  109.                 base, just add another line to your EVENT.SYS.  The contents
  110.                 of DOFAX.BAT are as follows:
  111.  
  112.                 ECHO OFF
  113.                 :START
  114.                 ECHOFAX %1
  115.                 IF EXIST DOFAXE.YES CALL FAXE
  116.                 IF EXIST ECHOFAX.END GOTO END
  117.                 GOTO START
  118.                 :END
  119.  
  120.                 DOFAXE.YES and FAXE.BAT are created by EchoFax, and are used
  121.                 as key files to cycle into BitFax and eventually end.  Be
  122.                 sure to pass on the full drive, path and name of the message
  123.                 base in your batch file.  A typical example would be:
  124.  
  125.                 CALL DOFAX L:\MSGS\FAX
  126.  
  127.                 You may rename this Batch File to whatever name you desire.
  128.  
  129.  
  130. ECHOFAX.PGE --> OPTIONAL addition you can create that will be included on
  131.                 the Covering Letter.  Up to 51 lines please.
  132.  
  133.  
  134. ECHOFAX.PRE --> OPTIONAL ASCII Text file, containing a list of all valid
  135.                 dialing prefixes in your area, one prefix per line.  If
  136.                 EchoFax finds this file, it will compare the prefix from
  137.                 the number in the fax message against all entries in the
  138.                 PRE file and look for match.  If there is no match, the
  139.                 message will NOT be faxed out and the message will be
  140.                 toggled as read.
  141.  
  142. ECHOFAX.END --> Created by EchoFax when the program has completed its work.
  143.                 This is the key file that signals the end.  EchoFax will
  144.                 delete ECHOFAX.END when it first loads so you don't have to
  145.                 worry about it.  ECHOFAX.END will contain the date and time
  146.                 of when EchoFax completed its work.
  147.  
  148. ECHOFAX.LOG --> This is a LOG file appended to by EchoFax.  This log file
  149.                 will contain a list of everything EchoFax did during its
  150.                 run.  Message numbers fax, killed or toggled as Read will
  151.                 appear in the Log.  Any Errors will also show up here.
  152.                 It would be a good idea to read this file on a regular
  153.                 basis.  Since EchoFax appends to it, you may want to delete
  154.                 it or archive it on a regular basis as well.
  155.  
  156.  EFUSER.EXE --> USER EDITOR for EchoFax.  If you wish to give a user access
  157.                 to Long Distance faxing, use this program to add/edit their
  158.                 account and place any number of "credits" for use.  Remember
  159.                 that your users are going to be charged 2 credits for every
  160.                 fax as the covering letter is included.  How much you charge
  161.                 is up to you - I'd suggest $10.00 for 10 credits.
  162.  
  163.  
  164.  
  165. Setting up BitFax
  166. --------------------------------------------------------------------------
  167. I followed the instructions for BitFax when installing the software and
  168. suggest you do the same.  Make a subdirectory called BITFAX on your drive,
  169. change to the subdirectory, and copy the contents of the BitFax/SR Program
  170. disk into the subdirectory.  You should place the EchoFax files in this
  171. same directory, as EchoFax will read the Log file created by BitFax.
  172. You should set the BITFAX=\BITFAX environment variable in your autoexec.bat
  173. file, and include the BITFAX subdirectory in your PATH= statement.
  174.  
  175. Be sure to set your com port correctly on the fax card.  I run a Hayes
  176. Ultra on Com1 and have the fax card set to use Com3/IRQ 4.
  177.  
  178. Once your card is installed and your software is loaded onto the hard
  179. drive you should type BITFAX and set up the BitFax parameters.  Please
  180. follow the BitFax manual.  Their manual contains step by step instructions.
  181. I'd suggest you set the speaker OFF as it is quite noisy!
  182.  
  183.  
  184. Beta Tester Notes
  185. --------------------------------------------------------------------------
  186. Changes, as they are added, will be listed in a file called CHANGES.DOC.
  187. Beta Testers should be sure to read CHANGES.DOC each time you grab a
  188. newer release.  Releases will be available from my system for you to
  189. download when you like.  The filename will always be the same - so make
  190. your checks by using the File Date and Time stamps!
  191.  
  192.  
  193. Future Plans
  194. --------------------------------------------------------------------------
  195. What else did I miss?
  196.  
  197.